Inside Macintosh: /

QuickDraw 3D RAVE / QuickDraw 3D RAVE Reference

QuickDraw 3D RAVE Routines / Managing Drawing Engines

QADeviceGetFirstEngine

You can use the QADeviceGetFirstEngine function to get the first drawing engine that can draw to a particular device.

TQAEngine *QADeviceGetFirstEngine (const TQADevice *device);

device

A device, or the value NULL.

DESCRIPTION

The QADeviceGetFirstEngine function returns, as its function result, the first drawing engine that is capable of drawing into the device specified by the device parameter. The first engine is defined to be the first engine that satisfies one of these criteria:

1. The drawing engine selected by the user (for example, using the RAVE control panel).
2. The drawing engine that is tightly coupled to the specified device (that is, that can render only to that device).
3. The drawing engine that accelerates more features than any other drawing engine.

If you pass the value NULL in the device parameter, QADeviceGetFirstEngine returns a drawing engine without regard for its ability to drive any particular device. You can use this technique to find all available engines.